使用 IronOCR 在 C# 中提取護照資料。

如何在 C# 中提取護照資料？

例如，我們將使用護照影像作為輸入來展示 IronOCR 的功能。 使用OcrInput載入影像後，您可以利用ReadPassport方法識別和提取護照資訊。 此方法傳回一個OcrPassportResult對象，其中包含GivenNames 、 Country 、 PassportNumber 、 Surname 、 DateOfBirth和DateOfExpiry等屬性。 PassportInfo物件的所有成員均為字串。

ReadPassport 方法是 IronOCR 專門的文件讀取功能的一部分，該功能還包括用於讀取車牌、MICR 支票和其他結構化文件的方法。 此方法使用先進的 電腦視覺技術來自動定位並擷取 MRZ (Machine Readable Zone) 區域。

我應該使用何種護照影像格式？

IronOCR 支援各種 影像格式，包括 JPG、PNG、TIFF 和 BMP。為了達到最佳效果，請確保您的護照影像有足夠的解析度 (至少 300 DPI) 和適當的光線。 DPI設定可在使用較低品質掃描時進行調整。

:path=/static-assets/ocr/content-code-examples/how-to/read-passport-read-passport.cs

using IronOcr;
using System;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputPassport = new OcrInput();

inputPassport.LoadImage("passport.jpg");

// Perform OCR
OcrPassportResult result = ocr.ReadPassport(inputPassport);

// Output passport information
Console.WriteLine(result.PassportInfo.GivenNames);
Console.WriteLine(result.PassportInfo.Country);
Console.WriteLine(result.PassportInfo.PassportNumber);
Console.WriteLine(result.PassportInfo.Surname);
Console.WriteLine(result.PassportInfo.DateOfBirth);
Console.WriteLine(result.PassportInfo.DateOfExpiry);

Imports IronOcr
Imports System

' Instantiate OCR engine
Private ocr = New IronTesseract()

Private inputPassport = New OcrInput()

inputPassport.LoadImage("passport.jpg")

' Perform OCR
Dim result As OcrPassportResult = ocr.ReadPassport(inputPassport)

' Output passport information
Console.WriteLine(result.PassportInfo.GivenNames)
Console.WriteLine(result.PassportInfo.Country)
Console.WriteLine(result.PassportInfo.PassportNumber)
Console.WriteLine(result.PassportInfo.Surname)
Console.WriteLine(result.PassportInfo.DateOfBirth)
Console.WriteLine(result.PassportInfo.DateOfExpiry)

我可以期待 ReadPassport 帶來哪些輸出？

擷取的資料會以結構化的格式傳回，方便與現有系統整合。 OcrResult 類別提供對所有萃取資訊的全面存取。

然後我們訪問從OcrPassportResult物件取得的PassportInfo資料成員。 擷取過程會自動處理各種護照版面與格式，在不同簽發國家提供一致的結果。

• GivenNames ： PassportInfo的屬性，以字串形式傳回護照輸入的姓名。 這對應於 MRZ 資料的第一行，位置 4 到 44。
• Country ： PassportInfo的一個屬性，以字串形式傳回護照輸入的國家。 這對應到 MRZ 資料的第一行，位置 2 到 3。 傳回的字串拼出簽發國家的全名，而不是縮寫。 在我們的範例中，USA 返回"美利堅合眾國"。
• PassportNumber ： PassportInfo的屬性，以字串形式傳回護照輸入的護照號碼。 這相對應於第二個 MRZ 資料列，位置 1 到 9。
• Surname ： PassportInfo的屬性，以字串形式傳回護照輸入的姓氏。 這對應於 MRZ 資料的第一行，位置 4 到 44。
• DateOfBirth ： PassportInfo的屬性，以 YYYY-MM-DD 格式的字串傳回護照輸入的出生日期。 這相對應於第二個 MRZ 資料列，位置 14 到 19。
• DateOfExpiry ： PassportInfo的一個屬性成員，以 YYYY-MM-DD 格式傳回護照輸入的到期日期字串。 這相對應於第二個 MRZ 資料列，位置 22 到 27。

---

我可以從護照中擷取哪些 MRZ 資訊？

IronOCR 可讀取任何遵循（國際民用航空組織）ICAO標準的護照底部兩行所包含的 MRZ 資訊。 MRZ 資料由兩行資料組成，每組位置都包含獨特的資訊。 以下是一個簡表，顯示哪些資訊與該行的索引相對應。

IronOCR 中的 MRZ 解析功能旨在處理印刷品質和 影像方向的變化。 對於具挑戰性的文件，您可以套用 影像修正篩選器來提高辨識準確度。

MRZ 部分是什麼樣子？

MRZ 通常位於護照頁面的底部，由兩行標準文字組成。 瞭解 MRZ 結構有助於排除萃取問題和驗證結果。

第一排

位置	領域	描述
1	文件類型	通常"P"代表護照。
2-3	簽發國	三字母國家代碼（ISO 3166-1 alpha-3）
4-44	姓氏和名字	姓氏後面跟著"<<"，名字後面跟著"<"分隔。

第二排

位置	領域	描述
1-9	護照號碼	唯一護照號碼
10	校驗位（護照號碼）	護照號碼校驗位
11-13	國籍	三字母國籍代碼（ISO 3166-1 alpha-3）
14-19	出生日期	出生日期（YYMMDD格式）
20	校驗位（出生日期）	出生日期校驗位
21	性別	性別（'M' 代表男性，'F' 代表女性，'X' 代表未指定）
22-27	到期日期	到期日（YYMMDD 格式）
28	校驗位（到期日）	有效期校驗位
29-42	個人號碼	可選的個人號碼（通常為國民身分證號碼）
43	校驗位（個人號碼）	個人號碼的校驗位
44	校驗位（複合）	整體校驗位

---

如何調試和驗證護照擷取結果？

我們也可以從 IronOCR 中驗證結果，從護照影像中取得原始抽取的文字以及置信度，確認抽取的資訊是否正確。 以上述範例為例，我們可以存取OcrPassportResult物件的Confidence和Text屬性。

為了除錯的目的，您可能想要高亮顯示文字區域來直觀地驗證哪些區域被辨識出來。 此功能在排除抽取問題或最佳化掃描區域時尤其有用。

:path=/static-assets/ocr/content-code-examples/how-to/read-passport-debug.cs

using IronOcr;
using System;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputPassport = new OcrInput();

inputPassport.LoadImage("passport.jpg");

// Perform OCR
OcrPassportResult result = ocr.ReadPassport(inputPassport);

// Output Confidence level and raw extracted text
Console.WriteLine(result.Confidence);
Console.WriteLine(result.Text);

Imports IronOcr
Imports System

' Instantiate OCR engine
Private ocr = New IronTesseract()

Private inputPassport = New OcrInput()

inputPassport.LoadImage("passport.jpg")

' Perform OCR
Dim result As OcrPassportResult = ocr.ReadPassport(inputPassport)

' Output Confidence level and raw extracted text
Console.WriteLine(result.Confidence)
Console.WriteLine(result.Text)

。

• Confidence ： OcrPassportResult的Confidence屬性是一個浮點數，表示 OCR 統計準確度置信度，即每個字元的平均值。 如果護照影像模糊或包含其他資訊，則此浮動值較低。 1 代表最高和最有信心，0 代表最低和最沒信心。 對於生產應用程式，請考慮實施 結果置信度臨界值，以確保資料品質。
• Text ： OcrPassportResult的Text屬性包含從護照影像中提取的原始、未解析的文字。 開發人員可在單元測試中使用，以驗證擷取的護照影像文字。 針對進階方案，您可以 hOCR 格式匯出結果，以便進一步分析。

護照掃描應用程式的最佳實務

在生產環境中實施護照掃描時，請考慮這些額外因素：

1.影像品質：確保輸入的影像符合最低品質標準。 Filter Wizard 可協助最佳化影像，以獲得更好的辨識度。

2.效能：若要進行大量處理，請執行 async 支援，並考慮批次處理多本護照。

3.安全性： 由於護照資料相當敏感，因此必須確保資料處理得宜，並考慮與安全的文件管理系統整合。

4.驗證：針對擷取的 MRZ 資料執行校驗位元驗證，以確保準確性。 MRZ 格式包含多個校驗碼，可用於驗證擷取資訊的完整性。

5.錯誤處理：針對護照影像可能受損、光線不足或包含非標準格式的情況，實施健全的錯誤處理。